Returns the number of milliseconds between midnight, January 1, 1970 Universal Coordinated Time (UTC) (or GMT) and the supplied date.


Date.UTC(year, month, day[, hours[, minutes[, seconds[,ms]]]])

Arguments

year: Required. The full year designation is required for cross-century date accuracy. If year is between 0 and 99 is used, then year is assumed to be 1900 + year.

month: Required. The month as an integer between 0 and 11 (January to December).

day: Required. The date as an integer between 1 and 31.

hours: Optional. Must be supplied if minutes is supplied. An integer from 0 to 23 (midnight to 11pm) that specifies the hour.

minutes: Optional. Must be supplied if seconds is supplied. An integer from 0 to 59 that specifies the minutes.

seconds: Optional. Must be supplied if milliseconds is supplied. An integer from 0 to 59 that specifies the seconds.

ms: Optional. An integer from 0 to 999 that specifies the milliseconds.

Remarks

The UTC method returns the number of milliseconds between midnight, January 1, 1970 UTC and the supplied date. This return value can be used in the setTime method and in the Date object constructor. If the value of an argument is greater than its range, or is a negative number, other stored values are modified accordingly. For example, if you specify 150 seconds, JScript redefines that number as two minutes and 30 seconds.

The difference between the UTC method and the Date object constructor that accepts a date is that the UTC method assumes UTC, and the Date object constructor assumes local time.

The UTC method is a static method. Therefore, a Date object does not have to be created before it can be used.

Note
If year is between 0 and 99, use 1900 + year for the year.

Example

The following example illustrates the use of the UTC method.

┬á	Copy Code
function DaysBetweenDateAndNow(yr, mo, dy){ var d, r, t1, t2, t3; //Declare variables. var MinMilli = 1000 * 60 //Initialize variables. var HrMilli = MinMilli * 60 var DyMilli = HrMilli * 24 t1 = Date.UTC(yr, mo - 1, dy) //Get milliseconds since 1/1/1970. d = new Date(); //Create Date object. t2 = d.getTime(); //Get current time. if (t2 >= t1) t3 = t2 - t1; else t3 = t1 - t2; r = Math.round(t3 / DyMilli); return(r); //Return difference. }

┬á

Copy Code

function DaysBetweenDateAndNow(yr, mo, dy){
   var d, r, t1, t2, t3;            //Declare variables.
   var MinMilli = 1000 * 60         //Initialize variables.
   var HrMilli = MinMilli * 60
   var DyMilli = HrMilli * 24
   t1 = Date.UTC(yr, mo - 1, dy)    //Get milliseconds since 1/1/1970.
   d = new Date();                  //Create Date object.
   t2 = d.getTime();                //Get current time.
   if (t2 >= t1) 
      t3 = t2 - t1;
   else
      t3 = t1 - t2;
   r = Math.round(t3 / DyMilli);
   return(r);                       //Return difference.
}

Requirements

Version 1

Applies To: Date Object (JScript 5.6)

Arguments

Remarks

Example

Requirements

See Also

Reference